home *** CD-ROM | disk | FTP | other *** search
/ mac CD 73 / Image.iso / macware / SwitchRes 2.4.1 ƒ / Read me < prev    next >
Text File  |  2000-09-08  |  17KB  |  275 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Version 2.4.1
  8.  
  9.                                        Stéphane Madrau
  10.  
  11.  
  12. Introduction
  13.  
  14. SwitchRes is an utility built around a Control Panel and an Extension. It will allow you to control and automate the resolutions of all your monitors. It is distributed with a Control Strip Module and a Contextual Menu Item, so that it’s always available everywhere.
  15.  
  16. SwitchRes is completely configurable. You can define which resolutions are really accessible, and which will require a confirmation. A new option allows you to redirect a resolution on an other, in all applications.
  17.  
  18. You can save the position of the icons on your desktop, independently from one resolution to the other, unlike the Finder. The position of the icons is restored at startup.
  19.  
  20. You can also create ‘display sets’ which will allow you to change the resolution, the depth and position of all your monitors, and to use an AppleScript with one click, or one key.
  21.  
  22. You can assign a specific Set to an application, so that every time you use this application, your Mac will automatically switch to predefined resolutions.
  23.  
  24. Configuration
  25.  
  26. SwitchRes will require a Mac with at least MacOS 8. SwitchRes is fully compatible with MacOS 8.5 (and 8.6) and will use all its features (Navigation Services, theme–switchable Appearance, PowerPC version of the Control Strip Module, Location Manager Module…)
  27.  
  28. Shareware
  29.  
  30. SwitchRes is distributed as a $15 shareware. This version is an evaluation version. You can use it for 10 days. After that, the preferences saving and restoring will be deactivated. To unlock SwitchRes, you will have to register. You can use the included ‘Register’ application.
  31. Don’t forget to write your address or eMail address, so that you can get the key to register.
  32.  
  33. Previous users of SwitchRes 1.x can upgrade for a special price. Please contact the author or take a look at the ‘Register’ application for more information.
  34.  
  35.                                                                                                                                                                                                                                              
  36. Installation
  37.  
  38. First, you’ll need to remove all previous version of SwitchRes extension in the Extensions folder.
  39.  
  40. Then, just drag and drop the ‘SwitchRes’ Extension and the ‘SwitchRes Control’ Control Panel on your system folder.
  41.  
  42. If you want to use the Control Strip Module, the Contextual Menu Item or the Location Manager module, drag them onto your System Folder too.
  43.  
  44. Then you have to restart your computer to use SwitchRes.
  45.  
  46. Note: Only the Extension is required to be in the System Folder. The Control Panel may be stored anywhere on your disk.
  47.  
  48.                                                                                                                                                                                                                                                 
  49. User interface – the menus
  50.  
  51. First menu
  52.  
  53. After restart, you have access to the SwitchRes menu in one of the following locations:
  54. – in the menu bar
  55. – in the Control Strip
  56. – in the Contextual Menu when clicking on the desktop
  57.  
  58. This menu will look like this:
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. if you have more than one display, then the display–specific options are grouped into hierarchical submenus:
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75. You can choose the resolution and the depth of the all monitors. 
  76.  
  77. The resolutions in italic (like 640 x 480, 120Hz) will require the traditional confirmation box. This dialog will be displayed for 5 seconds.
  78.  
  79. All options shown in this menu are completely configurable. You can choose to only show some options, independently from one menu to the other.
  80.  
  81. Secondary menu
  82.  
  83. The secondary menu will be displayed in the Control Strip by clicking on the SwitchRes icon while holding down the ‘’ key:
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90. This menu allows you to open the Control Panel. The Control Panel can also be opened on the Finder with a double-click on its icon.
  91.  
  92.                                                                                                                                                                                                                                                 
  93. Settings – The SwitchRes Control Panel
  94.  
  95. The Control Panel is divided in 6 parts, each represented by a button on the upper side of the dialog. 
  96. Preferences are saved when quitting the Control Panel or closing the dialog. All settings are applied immediately.
  97.  
  98. First part: General Preferences 
  99.  
  100.  
  101.  
  102.  
  103.  
  104. The buttons shown in this part of the dialog allow you to define startup settings:
  105.  
  106. • Allow or forbid all resolutions changes during the startup process. Try this option if you have an AppleVision or ColorSync ADB–driven monitor.
  107.  
  108. • Show or hide the SwitchRes icon at startup
  109.  
  110. • Set the resolution of every monitor attached after restart, let the Location Manager apply the 
  111. correct settings, or use a specific Display Set.
  112.  
  113. You can also change more SwitchRes’ general settings:
  114.  
  115. • Use the Navigation Services in the Control Panel
  116.  
  117. • Use a System–wide key shortcut for opening the Control Panel
  118.  
  119. • Add the Monitor number after its name
  120.  
  121. • Always activate SwitchRes. If you want SwitchRes to stay in memory, it will use some memory more, but it will be more sensitive, especially when saving icons. If you don’t use these features frequently, you can tell SwitchRes to release its used memory when not active.
  122.  
  123. • Define the delay SwitchRes will use when testing a new resolution. That delay allows you to validate the use of this resolution, by clicking on an alert displayed on screen (that obviously you could not see if the resolution is not valid).
  124.  
  125. • Activate the advanced user mode. In this mode, you won’t see any alert any more. Use this only if you know what you are doing.
  126.  
  127.                                                                                                                                                                                                                                                 Second part: 
  128.  
  129.  
  130.  
  131.  
  132.  
  133. You can see the resolution list of every monitor. The button under the list allows you to display all resolutions your video card is capable of. Warning: your monitor may not support all these resolutions. I’m not responsible of any damage caused to your monitor.
  134. Moreover, your video card does not necessarily handle these resolutions. In this case, no resolution change occurs.
  135.  
  136.  
  137. From left to right, in the list, you can see:
  138. • The resolution itself
  139. • The vertical refresh rate of this resolution
  140. • If this resolution is allowed or not (cross in the column if resolution is forbidden). With a control-click on this column, you can define the redirection of this resolution to an other one. This will allow you to play games in 640x480, 120Hz when they woud normally change the resolution to 640x480, 67Hz. Your eyes will like that!
  141. • If this resolution is displayed in the menu or not, or if it requires a confirmation alert box
  142. • If this resolution owns an icon setting
  143.  
  144. In front of this list, the options allow you to:
  145.  
  146. • Configure the menu: by displaying the refresh rate in the menu
  147. (Example: “640 x 480” or “640 x 480, 120Hz”)
  148. and by displaying a custom monitor type
  149. (Example: “Multiscan monitor”, “21” Multiscan monitor” or whatever you want)
  150.  
  151. • Keep same color depth – You can specify to keep the same depth or to use the deepest available when switching in a new resolution.
  152. • Export all the changes you make into a 3DFX Voodoo3ModePrefs file, for Voodoo3 video cards owners. This option is useful to synchronize your 3DFX preferences with the SwitchRes preferences.
  153.  
  154. • Import an other screen preferences: SwitchRes presents you a dislog, where you can select a display. The choices proposed are displays that you previously connected to your Mac. This allows you to use older preferences without having to redefine them entirely.
  155.  
  156. The Setup Wizard is a quick–and–easy way to configure your monitor: imagine you have to plug your PowerBook on a unknown external monitor, for a presentation. You just can select this tool and you’ll quickly have SwitchRes correctly configured for the right resolution.
  157.  
  158. You can give the wizard some clues about the physical characteristics of your monitor. These can be found in your monitor’s manual. SwitchRes will then activate only the resolutions that fall into these characteristics and will ask you to confirm that these resolutions are really visible.
  159.  
  160. Note that you can launch the Setup Wizard automatically at startup, by pressing the ‘S’ key during the restart. SwitchRes will play a little sound, telling you that your order has been taken into consideration, and will present you the standard testing dialog. This will allow a configuration of a monitor where you cannot see the screen at startup.
  161.  
  162.  
  163.                                                                                                                                                                                                                                                 Third part: 
  164.  
  165.  
  166.  
  167.  
  168.  
  169. In this part, you define the Display Sets.
  170. Display Sets are SwitchRes’ most useful feature. Their possibilities are far more advanced than only applying some resolution or depth changes. In fact, with AppleScript, they allow you to do almost everything, easily.
  171.  
  172. A Display Set contains the settings of all your monitors. This includes monitor resolution, color depth and even monitor position in a multiple display environment. Moreover, they can contain an AppleScript that will allow you to execute some actions when the set will be selected.
  173.  
  174. The Display Sets are activated either by a Key Shortcut, a selection in one menu, when an application starts, or brought to the front, and even at startup.
  175.  
  176. For each of these events, the Set will be applied. This goes far beyond a simple resolution change, because with just one key you might want to tell SwitchRes to open an application and automatically use the correct display settings.
  177.  
  178. Moreover, SwitchRes is smart enough to remember the display settings of monitors that are not attached permanently. That allows you to use the same Set on your PowerBook, whether the computer is used with the internal screen or with a second display attached.
  179.  
  180. SwitchRes allows you to put the Display Sets in its menus. You can define individually if a Display Set will appear in the menus. Last, the order in which Display Sets are shown in a menus is user–configurable. Just drag the Display Set’s name where you want it to appear, and all will be drawn consequently.
  181.  
  182.  
  183.                                                                                                                                                                                                                                                 Fourth part: 
  184.  
  185.  
  186.  
  187.  
  188.  
  189. In this part, you define the application settings. You can define settings that will be used for every application, and other settings that will be used for certain applications only, when the application is launched or brought to the front.
  190.  
  191. The principal settings are the Display Set and the sound level. That will allow you to launch a game with a correct sound level, and with the correct screen size. Of course, the older settings can be restored when the application quits.
  192.  
  193. Other interesting options in this section are:
  194. • Automatically hiding the Control Strip and the other Applications
  195. • Restoring the older settings when the application quits
  196. • Applying again the defined settings when the application is brought to front
  197.  
  198. The last application definable option is the ability to forbid every resolution change coming from the application itself. Only SwitchRes will be able to change the resolution. This is useful for games that will change your monitor to an hard–coded resolution.
  199.  
  200.                                                                                                                                                                                                                                                 Fifth part: 
  201.  
  202.  
  203.  
  204.  
  205.  
  206. This part lets you define what you want to see in the 3 SwitchRes menus: the Control Strip Menu, the Menu in the Menu bar and the Contextual Menu.
  207.  
  208. Here you can also activate or deactivate the menu in the menu bar of each application:
  209.  
  210.  
  211.  
  212. Try everything to choose what you like the most…!
  213.  
  214.                                                                                                                                                                                                                                                Sixth part: 
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221. This part let you define more precisely how SwitchRes will save and restore the position of all icons and the Finder windows
  222.  
  223. • You can allow SwitchRes to reposition the icons/windows after a specific delay after starting your Mac. You can change the delay, in order to wait for external hard drives to mount on the desktop.
  224.  
  225. • Automatically save the positions of the icons/windows of the desktop when a switch occurs. The button on the left or the last command of the menu is devoted to do this manually. Remember this can be time saving if you don’t change your icons frequently.
  226.  
  227. • Anchor your icons on their parent screen: when you move a display, the icons/windows can stay at their original position, or move along with the display. It’s up to you to decide which option is better.
  228.  
  229. • Tell SwitchRes to store only icons, or only windows, or even both when rearranging the desktop
  230.  
  231. • You can allow SwitchRes to place your icons at their exact position, or let it choose to place them on an invisible grid, so that icons are correctly aligned. The grid spacing can be changed.
  232. If you enable this option, a new command in the menus will be added, which allows you to rearrange your desktop when you want, without having to save/restore the icons.
  233.                                                                                                                                                                                                                                                 
  234. Various
  235.  
  236. Comments
  237.  
  238. For all comments, you can email me at:
  239.               stephane@ madrau.com
  240.  
  241. Thanks to…
  242.  
  243. David Nine, Tobias Jachmann, Mike Gerenser, Michael Kummer, Norbert M. Doerner, Kiran Wagle, John Moreno, John Zetlaoui, Sylvain-Pierre Dobrzynski, Lindsey Dubb, Franck Trommenschlager and Carsten Friehe for beta testing;
  244. Christoph Sahm for the German localisation, Joris Provoost for the Dutch one and Stefano Ghielmi for the Italian one;
  245. Ammon Skdimore for his help and some code exchange.
  246. Andreas Bauer for all the beautiful 32 bit icons.
  247.  
  248. History
  249.  
  250. New in version 2.4.1
  251. • When an applcation wants a forbidden resolution, SwitchRes tries from now to find a similar allowed resolution, and no more prevents the resolution change. This new behavior corrects some problems with games using DrawSprockets.
  252.  
  253. • A problème that occurs when launching some applications (Type 2 errors) is corrected
  254. • The Control Strip Module is simplified, allowing mode compatibility with GoMac/ExtensionsStrip/etc.
  255. • A bug in automatic icons saving/replacing has been corrected
  256. • Icons were replaced and moved horizontally on a Finder grid, even if this option was deactivated in the Control Panel
  257. • A bug when G3 B&W went out of sleep has been corrected
  258. • Added the option of saving preferences on new Voodoo5 video cards
  259. • Option of exporting Voodoo preferences file is only possible on cards that allow it, in mulitmonitor mode
  260.  
  261. • User name is filled automatically when registering
  262. • Corrected a display bug in the resolutions list in the Control Panel
  263.  
  264. New in version 2.4
  265. • Application monitoring was rewritten to correct some troubles which could occur with some applications (like Microsoft Internet Explorer) when they were associated to a Display Set
  266. • Displays relative position is restored after restart, even without defining a Display Set for that
  267. • Time for testing a resolution is now user definable, no more fixed to 5 seconds
  268. • You can now place Display Sets in menus individually
  269. • It’s now possible to activate and deactivate video mirroring from AppleScript
  270. • You can import other display preferences from the Control Panel: that option allows you to use an other video card’s preferences if you changed your card, without having to redefine all preferences by hand
  271.  
  272. • Alignement of Finder’s desktop items now works in “Buttons” mode (in MacOS 9)
  273. • Corrects some visual bugs in the Control Panel, and some errors in the balloon help
  274. • Author email adress and SwitchRes web page adress changed
  275.